home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / cdump142.zip / DUMP.DOC next >
Text File  |  1990-12-18  |  9KB  |  173 lines
  1. Cos File Dump Utility version 1.42c                (C)opyright 1990 Ofer Inbar
  2.  
  3. A summary of these instructions is displayed on the screen if you run Dump
  4. without any command line parameters.  Dump requires a filespec to run.
  5.  
  6. Syntax:
  7.  DUMP [ {/|-} option ] filespec [ {/|-} option ]
  8.  Filespec is any legal DOS file specification, which can include a drive name
  9.  and path name when necessary.  The option may appear before or after filespec,
  10.  but not both.  It can be preceeded by either a slash or a dash, and is not
  11.  case sensitive.  It is not necessary to separate the filespec from the option
  12.  by a space.  For example, all of the following Dump commands are equivalent:
  13.  
  14. DUMP FILE.BIN/T            DUMP /tFILE.BIN
  15. DUMP FILE.BIN /t        DUMP -T FILE.BIN
  16. DUMP FILE.BIN -t        DUMP -tFILE.BIN
  17. DUMP FILE.BIN-T            DUMP /T FILE.BIN
  18.  
  19. Action:
  20.  Dumps the specified file (filespec) to the standard output device.  This is
  21.  usually the screen, but can be redirected.  Any legal DOS pathname may be
  22.  used for the file, but no wildcards are allowed.  Dump can use a variety of
  23.  formats for diplaying the contents of the file.  You choose a Dump format by
  24.  specifying one of the options described below.  While Dump is running, you
  25.  may pause it by hitting any key (except <Shft>, <Alt>, <Ctrl>, ...).  Hitting
  26.  a key again will resume dumping.  You can abort and return to DOS at any time
  27.  by hitting the <ESC> key.
  28.  
  29. Options: (D is the default format)
  30.  
  31. D or d  Dump  - Debug's memory dump format; 16 bytes/line
  32.  This is the default format, and will be used when no option is specified.
  33.  This format looks like the output of Debug's D command, except that file
  34.  offsets are used instead of addresses.  Each line begins with an offset,
  35.  then lists 16 bytes in hex format, with spaces separating.  There is a dash
  36.  between the eighth and ninth bytes.  At the end of the line is an ASCII
  37.  interpretation of those 16 bytes, in 16 characters.  Most graphics chars
  38.  are displayed, but some control characters are replaced by dots.  This is
  39.  the only significant departure from Debug, which replaces all control,
  40.  graphics, and foreign characters by periods.
  41.  
  42.  Here is a sample line in /D format:
  43.   8B0:  51 42 50 04 01 00 02 00 - 01 00 00 00 01 00 04 49   QBP·· · ·   · ·O
  44.  
  45. W or w  Wide  - 32 bytes/line, requires 132 columns
  46.  This option produces output very similar to /D, except that 32 bytes are shown
  47.  on each line, both in hex and ASCII.  This option produces 132 column wide
  48.  output.  If your screen is only 80 columns wide, the lines will be divided and
  49.  hard to read.  The most common use for wide output is to redirect it to a wide
  50.  carriage printer.  If your printer is 80 columns, you can usually set it to
  51.  compressed text mode and it will print 132 columns.  Check the printer manual.
  52.  
  53. H or h  Hex   - 24 bytes/line, hex representation only
  54.  This format displays only hex, like the middle part of the screen in the /D
  55.  format.  Using the extra text columns at the right edge of the screen, it
  56.  shows an additional 8 bytes on each line, for a total of 24 bytes in 80
  57.  columns.
  58.  
  59.  
  60.  
  61. A or a  ASCII - 80 chars/line, ctrl chars as periods
  62.  This format is similar to the format at the right edge of the screen in /D.
  63.  The entire file is shown only as ASCII, using the full 80 columns.  This means
  64.  that 80 bytes are shown on each line, making this the most compact format.
  65.  /A interprets characters exactly like /D - most graphics characters are shown,
  66.  but some control characters are displayed as periods.  Null bytes (0) are
  67.  shown as spaces.
  68.  
  69. T or t  Text  - strips off all binary characters
  70.  This format interprets the file as ASCII, and ignores all non-text characters.
  71.  Characters with ASCII codes 9-10, 12-13, 32 - 127 are considered normal text
  72.  characters and are not ignored.  All special characters are treated normally.
  73.  I.e. TAB (9) moves the cursor eight spaces, and CR (13) starts a new line.
  74.  The exception is that FF (12) is shown on screen as a Venus symbol (mirror),
  75.  although it acts normally on the printer (issues a form feed, or page break).
  76.  Thus, using this format on a text file will have the same effect as DOS's TYPE
  77.  command.  But, unlike TYPE, DUMP /T will not stop at an EOF character (26).
  78.  Since DUMP /T will ignore non-text characters, it can be used as an ASCII
  79.  "stripper."  It will show all the text in a binary file, and this output can
  80.  be redirected to another file.  This can be useful, for example, if a word
  81.  processor document is damaged and the word processor cannot open the file.
  82.  Use DUMP /T to extract the text from the document into a new ASCII file, and
  83.  import the file into your word processor.  You will lose all formatting, but
  84.  you should be able to recover most of the text this way.  Another use of this
  85.  ASCII stripping capability is to get all of the messages from a program's .EXE
  86.  file.  Also, since DUMP will issue a CR (13) when it encounters and LF (10),
  87.  it can be used to translate a Unix format text file to MS-DOS format.
  88.  
  89. Examples:
  90.  The following examples illustrate how to use Dump.  Each example starts with a
  91.  sample command line, and then describes what that command does.
  92.  
  93. DUMP file.dat
  94.  Dumps file.dat to the screen in the default format (/D).
  95.  
  96. DUMP file.exe/T >file.txt
  97.  All text that is in file.exe is copied into file.txt.  File.txt now contains
  98.  all of the text strings and messages stored in the program file.exe.
  99.  Note the use of the DOS redirection character (>) to redirect standard output
  100.  to a file.  Also note that a space is not needed between the filename and the
  101.  option switch.
  102.  
  103. DUMP -w file.bin >prn
  104.  This dumps file.bin, a binary file, in 132 column format, showing 32 bytes on
  105.  each line.  The redirection character is used to redirect output to the first
  106.  printer (PRN).  Note that although a space is not required between the option
  107.  and the filename, one is included for clarity.  You can achieve the same
  108.  result by typing DUMP -WFILE.BIN>PRN
  109.  
  110. Here is a list of the DOS devices you may want to use for redirecting output.
  111.  LPT1:  Line PrinTer 1          First parallel printer
  112.  LPT2:  Line PrinTer 2          Second parallel printer
  113.  LPT3:  Line PrinTer 3          Third parallel printer
  114.  COM1:  COMmunications port 1   First serial port; modem or serial printer
  115.  COM2:  COMmunications port 2   Second serial port; modem or serial printer
  116.  COM3:  COMmunications port 3   Third serial port; modem or serial printer
  117.  COM4:  COMmunications port 4   Fourth serial port; modem or serial printer
  118.  PRN:   PRiNter                 Synonym for LPT1:
  119.  AUX:   AUXilliary              Synonym for COM1:
  120.  CON:   CONsole                 Screen (for output), the default STDOUT device.
  121.  NUL:   NULl device             "Bit bucket"; all output discarded
  122. *CLOCK  CLOCK                   DOS system clock; do not use this one.
  123.  
  124.  
  125. Errors:
  126.  This section describes the causes and meanings of the error messages that
  127.  Dump reports when something is wrong.
  128.  
  129. DUMP: No filename specified
  130.  You specified an option switch on the Dump command line, but gave no filename.
  131.  For example: DUMP /A
  132.  
  133. DUMP: Unrecognized option: letter
  134.  You used the option switch character (/ or -) but the following character was
  135.  not one of the five format letters Dump recognizes (D, W, H, A, or T).
  136.  For example: DUMP file.ext -R
  137.  Dump responds: DUMP: Unrecognized option: R
  138.  
  139. DUMP: Cannot open file: filename
  140.  Dump encountered an error trying to open the file.  There are several possible
  141.  causes for this:
  142. A) There is damage on the area of the disk the file or its directory occupies.
  143. B) The file has been opened by another program with the DENY WRITE attribute.
  144. C) There are not enough file handles.  Check the "FILES=" line in CONFIG.SYS.
  145. D) The file doesn't exist and the directory is full (applies to root dir only).
  146.  
  147. DUMP: File not found: filename
  148.  There was no file with the name you specified.  If the file you specify
  149.  does exist but is zero length, Dump deletes it and gives this error.
  150.  
  151. DUMP: Disk error reading file at offset: address
  152.  A disk read error occurred while trying to read the file.  The addre